home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / glmapgrid.z / glmapgrid
Encoding:
Text File  |  2001-04-17  |  7.0 KB  |  133 lines

  1.  
  2.  
  3.  
  4. ggggllllMMMMaaaappppGGGGrrrriiiidddd((((3333GGGG))))                  OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                  ggggllllMMMMaaaappppGGGGrrrriiiidddd((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllMMMMaaaappppGGGGrrrriiiidddd1111dddd,,,, ggggllllMMMMaaaappppGGGGrrrriiiidddd1111ffff,,,, ggggllllMMMMaaaappppGGGGrrrriiiidddd2222dddd,,,, ggggllllMMMMaaaappppGGGGrrrriiiidddd2222ffff - define a one- or
  10.      two-dimensional mesh
  11.  
  12.  
  13. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  14.      void ggggllllMMMMaaaappppGGGGrrrriiiidddd1111dddd( GLint _u_n,
  15.                        GLdouble _u_1,
  16.                        GLdouble _u_2 )
  17.      void ggggllllMMMMaaaappppGGGGrrrriiiidddd1111ffff( GLint _u_n,
  18.                        GLfloat _u_1,
  19.                        GLfloat _u_2 )
  20.      void ggggllllMMMMaaaappppGGGGrrrriiiidddd2222dddd( GLint _u_n,
  21.                        GLdouble _u_1,
  22.                        GLdouble _u_2,
  23.                        GLint _v_n,
  24.                        GLdouble _v_1,
  25.                        GLdouble _v_2 )
  26.      void ggggllllMMMMaaaappppGGGGrrrriiiidddd2222ffff( GLint _u_n,
  27.                        GLfloat _u_1,
  28.                        GLfloat _u_2,
  29.                        GLint _v_n,
  30.                        GLfloat _v_1,
  31.                        GLfloat _v_2 )
  32.  
  33.  
  34. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  35.      _u_n  Specifies the number of partitions in the grid range interval [_u_1,
  36.          _u_2].  Must be positive.
  37.  
  38.      _u_1, _u_2
  39.          Specify the mappings for integer grid domain values i = 0 and i = un.
  40.  
  41.      _v_n  Specifies the number of partitions in the grid range interval [_v_1,
  42.          _v_2] (ggggllllMMMMaaaappppGGGGrrrriiiidddd2222 only).
  43.  
  44.      _v_1, _v_2
  45.          Specify the mappings for integer grid domain values j = 0 and j = vn
  46.          (ggggllllMMMMaaaappppGGGGrrrriiiidddd2222 only).
  47.  
  48. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  49.      ggggllllMMMMaaaappppGGGGrrrriiiidddd and ggggllllEEEEvvvvaaaallllMMMMeeeesssshhhh are used together to efficiently generate and
  50.      evaluate a series of evenly-spaced map domain values.  ggggllllEEEEvvvvaaaallllMMMMeeeesssshhhh steps
  51.      through the integer domain of a one- or two-dimensional grid, whose range
  52.      is the domain of the evaluation maps specified by ggggllllMMMMaaaapppp1111 and ggggllllMMMMaaaapppp2222.
  53.  
  54.      ggggllllMMMMaaaappppGGGGrrrriiiidddd1111 and ggggllllMMMMaaaappppGGGGrrrriiiidddd2222 specify the linear grid mappings between the i
  55.      (or i and j) integer grid coordinates, to the u (or u and v) floating-
  56.      point evaluation map coordinates.  See ggggllllMMMMaaaapppp1111 and ggggllllMMMMaaaapppp2222 for details of
  57.      how u and v coordinates are evaluated.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllMMMMaaaappppGGGGrrrriiiidddd((((3333GGGG))))                  OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                  ggggllllMMMMaaaappppGGGGrrrriiiidddd((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      ggggllllMMMMaaaappppGGGGrrrriiiidddd1111 specifies a single linear mapping such that integer grid
  75.      coordinate 0 maps exactly to _u_1, and integer grid coordinate _u_n maps
  76.      exactly to _u_2.  All other integer grid coordinates i are mapped so that
  77.  
  78.                                u = i(u2-u1)/un + u1
  79.  
  80.      ggggllllMMMMaaaappppGGGGrrrriiiidddd2222 specifies two such linear mappings.  One maps integer grid
  81.      coordinate i = 0 exactly to _u_1, and integer grid coordinate i = un
  82.      exactly to _u_2.  The other maps integer grid coordinate j = 0 exactly to
  83.      _v_1, and integer grid coordinate j = vn exactly to _v_2.  Other integer grid
  84.      coordinates i and j are mapped such that
  85.  
  86.                                u = i(u2-u1)/un + u1
  87.  
  88.                                v = j(v2-v1)/vn + v1
  89.  
  90.      The mappings specified by ggggllllMMMMaaaappppGGGGrrrriiiidddd are used identically by ggggllllEEEEvvvvaaaallllMMMMeeeesssshhhh
  91.      and ggggllllEEEEvvvvaaaallllPPPPooooiiiinnnntttt.
  92.  
  93. EEEERRRRRRRROOOORRRRSSSS
  94.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if either _u_n or _v_n is not positive.
  95.  
  96.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllMMMMaaaappppGGGGrrrriiiidddd is executed between the
  97.      execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  98.  
  99. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  100.      ggggllllGGGGeeeetttt with argument GGGGLLLL____MMMMAAAAPPPP1111____GGGGRRRRIIIIDDDD____DDDDOOOOMMMMAAAAIIIINNNN
  101.      ggggllllGGGGeeeetttt with argument GGGGLLLL____MMMMAAAAPPPP2222____GGGGRRRRIIIIDDDD____DDDDOOOOMMMMAAAAIIIINNNN
  102.      ggggllllGGGGeeeetttt with argument GGGGLLLL____MMMMAAAAPPPP1111____GGGGRRRRIIIIDDDD____SSSSEEEEGGGGMMMMEEEENNNNTTTTSSSS
  103.      ggggllllGGGGeeeetttt with argument GGGGLLLL____MMMMAAAAPPPP2222____GGGGRRRRIIIIDDDD____SSSSEEEEGGGGMMMMEEEENNNNTTTTSSSS
  104.  
  105.  
  106. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  107.      ggggllllEEEEvvvvaaaallllCCCCoooooooorrrrdddd, ggggllllEEEEvvvvaaaallllMMMMeeeesssshhhh, ggggllllEEEEvvvvaaaallllPPPPooooiiiinnnntttt, ggggllllMMMMaaaapppp1111, ggggllllMMMMaaaapppp2222
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.